IApi.EnableShutdownHandler 方法
當 EtherCAT 連結被建立時,附上一個關閉處置器 (Shutdown Handler)。此方法可在 Windows 關閉或當機時,允許 KINGSTAR Runtime 繼續執行。使用 EnableShutdownHandler 時,您的應用程式需使用 RTX64 的 RtAttachShutdownHandler 函式,以讓應用程式在關閉模式中執行。
RtAttachShutdownHandler 是一個僅能用於 RTX64 應用程式的即時 (RT) 函式,因此,若要使用 EnableShutdownHandler,您須具備一個 RTX64 使用者應用程式。
命名空間:IntervalZero.KINGSTAR.Base.Api組合: IntervalZero.KINGSTAR.Base.Api (於 IntervalZero.KINGSTAR.Base.dll) 版本:4.4.0.0
語法
KsError EnableShutdownHandler(
bool Active
)
Function EnableShutdownHandler(
Active As Boolean
) As KsError
參數
Active
型別:bool
true:啟用關閉處置器;false:停用關閉處置器。預設為 false。
回傳值
型別:KsError
方法的回傳值。
備註
- 此方法須在 Create 或 CreateAsync 後及 Start 前呼叫。
- 欲解除電腦關閉模式,使用者應用程式應呼叫 Stop 以令 KS 終止其關閉處置器。
可用的 EtherCAT 狀態
ecatOffline
範例
N/A
參見